From 98f4389e40357fc635d13438d8c7a3cae5b80aa2 Mon Sep 17 00:00:00 2001 From: robertl Date: Thu, 23 Nov 2006 04:45:54 +0000 Subject: [PATCH] Add words for transform filter. Make 'makedoc..in' format section headers in generated doc. git-svn-id: http://gpsbabel.googlecode.com/svn/trunk@2529 f51c46e8-681c-474f-0cfe-069cfd0219fb --- gpsbabel/Makefile.in | 2 +- gpsbabel/filter_vecs.c | 2 +- gpsbabel/xmldoc/filters/options/transform-del.xml | 12 ++++++++++++ gpsbabel/xmldoc/filters/options/transform-rte.xml | 12 ++++++++++++ gpsbabel/xmldoc/filters/options/transform-trk.xml | 14 ++++++++++++++ gpsbabel/xmldoc/filters/options/transform-wpt.xml | 12 ++++++++++++ gpsbabel/xmldoc/makedoc.in | 6 +++--- 7 files changed, 55 insertions(+), 5 deletions(-) create mode 100644 gpsbabel/xmldoc/filters/options/transform-del.xml create mode 100644 gpsbabel/xmldoc/filters/options/transform-rte.xml create mode 100644 gpsbabel/xmldoc/filters/options/transform-trk.xml create mode 100644 gpsbabel/xmldoc/filters/options/transform-wpt.xml diff --git a/gpsbabel/Makefile.in b/gpsbabel/Makefile.in index 5db824248..6a878c803 100644 --- a/gpsbabel/Makefile.in +++ b/gpsbabel/Makefile.in @@ -104,7 +104,7 @@ gpsbabel$(EXEEXT): configure Makefile $(OBJS) @GPSBABEL_DEBUG@ gpsbabel-debug: $(OBJS) $(CC) $(CFLAGS) $(LDFLAGS) $(OBJS) @LIBS@ @EFENCE_LIB@ @EXPAT_LIB@ @USB_LIBS@ $(OUTPUT_SWITCH)$@ -Makefile: Makefile.in config.status +Makefile: Makefile.in config.status xmldoc/makedoc.in CONFIG_FILES=$@ CONFIG_HEADERS= $(SHELL) ./config.status gbversion.h: configure config.status diff --git a/gpsbabel/filter_vecs.c b/gpsbabel/filter_vecs.c index 8dee6d560..75e4a5e1c 100644 --- a/gpsbabel/filter_vecs.c +++ b/gpsbabel/filter_vecs.c @@ -115,7 +115,7 @@ fl_vecs_t filter_vec_list[] = { { &transform_vecs, "transform", - "Transformate waypoints into a route, tracks into routes, ..." + "Transform waypoints into a route, tracks into routes, ..." }, #endif { diff --git a/gpsbabel/xmldoc/filters/options/transform-del.xml b/gpsbabel/xmldoc/filters/options/transform-del.xml new file mode 100644 index 000000000..f8b6ddaac --- /dev/null +++ b/gpsbabel/xmldoc/filters/options/transform-del.xml @@ -0,0 +1,12 @@ + +This option, when used in connction with the wpt, rte, or trk options, tells +GPSBabel to delete the source data after conversion. This is most useful if +you are trying to avoid duplicated data in the output. + + +Convert a GPX track to GPX waypoints, tossing the original track + +gpsbabel -i gpx -f blah.gpx -x transform,wpt,del \ +-o gpx -F converted.gpx + + diff --git a/gpsbabel/xmldoc/filters/options/transform-rte.xml b/gpsbabel/xmldoc/filters/options/transform-rte.xml new file mode 100644 index 000000000..4edd958a3 --- /dev/null +++ b/gpsbabel/xmldoc/filters/options/transform-rte.xml @@ -0,0 +1,12 @@ + +This option selects the destination type of this filter to be routes. Choose this when you want to convert tracks into waypoints routes. A single route will be created in the sequence they appear in the input. + + +Converting a pile of waypoints to a GPX route + +Say you you have a data file that came from CSV file that you want to convert +to a GPX route that can be loaded into Mapsource. Use the following command: +gpsbabel -i csv -f blah.txt -x transform,rte \ +-o gdb -F blah.gdb + + diff --git a/gpsbabel/xmldoc/filters/options/transform-trk.xml b/gpsbabel/xmldoc/filters/options/transform-trk.xml new file mode 100644 index 000000000..25652cfc4 --- /dev/null +++ b/gpsbabel/xmldoc/filters/options/transform-trk.xml @@ -0,0 +1,14 @@ + +This option selects the destination type of this filter to be tracks. +Choose this when you want to create tracks from a list of waypoints or routes. +A single track will be created in the sequence they appear in the input. + + +Converting a pile of waypoints to a GPX track + +Say you you have a data file that came from CSV file that you want to convert +to a GPX track that can be loaded into Mapsource. Use the following command: +gpsbabel -i csv -f blah.txt -x transform,trk \ +-o gdb -F blah.gdb + + diff --git a/gpsbabel/xmldoc/filters/options/transform-wpt.xml b/gpsbabel/xmldoc/filters/options/transform-wpt.xml new file mode 100644 index 000000000..982f84ce4 --- /dev/null +++ b/gpsbabel/xmldoc/filters/options/transform-wpt.xml @@ -0,0 +1,12 @@ + +This option selects the destination type of this filter to be waypoints. +Choose this when you want to convert tracks or routes into waypoints. + + +Converting a track to a sequence of waypoints + +Say you you have a KML file that contains a track but you want to convert it to a CSV file that can contain only waypoints, perhaps to import into a spreadsheet. Use the following command: +gpsbabel -i kml -f blah.kml -x transform,wpt \ +-o csv -F blah.txt + + diff --git a/gpsbabel/xmldoc/makedoc.in b/gpsbabel/xmldoc/makedoc.in index cf3b354ea..4a8b45b72 100755 --- a/gpsbabel/xmldoc/makedoc.in +++ b/gpsbabel/xmldoc/makedoc.in @@ -11,7 +11,7 @@ sub expandrw { my $res = ""; if ( ($read eq 'r') || ($write eq 'w')) { - $res .= " \n \n "; + $res .= " \n \n "; if ( ($read eq 'r') && ($write eq 'w')) { $res .= "read and write $type"; } @@ -28,13 +28,13 @@ sub expandrw { sub expandoptions { my $opts = shift; - my $res = " \n This format can...\n \n"; + my $res = " \n This format can...\n \n"; $res .= expandrw( substr($opts,0,1), substr($opts,1,1), 'waypoints' ); $res .= expandrw( substr($opts,2,1), substr($opts,3,1), 'tracks' ); $res .= expandrw( substr($opts,4,1), substr($opts,5,1), 'routes' ); - $res .= " \n \n"; + $res .= " \n"; $res; } -- 2.30.2